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1. INTRODUCTION. 



1.1. Purpose. 

This document is a user manual for the I'C software module IIC51. It is intended for Intel PLM51 
users who need to control an I'C bus. This document assumes some basic Knowledge about I'C 
and Intel PLM51 . 



1.2. Scope. 

IIC51 is a software module to provide an Intel PLM51 user with a set of procedures to control a 
bi-directional I'C bus. These procedures have been coded in Intel ASM51 and have been optimized 
for speed. IIC51 supports all common used I'C master transmitter and master receiver protocols. 
Each different protocol corresponds to one of the procedures in IIC51. IIC51 is available in two 
different versions: 

IIC51S: 

IIC51S is a module for singlemaster I'C to be used on microcontrollers of the 8xC51 family. 
It directly controls the microcontroller I/O pins by software without the need of any specific 
hardware. No other I'C masters are allowed on the bus. Note that the electrical characteristics 
of this microcontroller family are not conform the I'C specifications. 

IIC51M: 

IIC51M is a module for multimaster I'C to be used on microcontrollers of the PCB8xC552/C652 
family. It makes use of the built-in I'C interface hardware (SI01) of these microcontrollers. 
Since this hardware is a muftimaster interface other I'C masters are allowed on the bus. 

All I'C transfer procedures in IIC51S are fully software interface compatible with IIC51M. This allows 
a single PLM51 program using I'C to be written for both mentioned microcontroller families. 



I'C Inler-IC bus 

PLM51 High level Program Language tor 8051 family Microcontrollers 

ASM51 Assembly Language for 8051 family Microcontrollers 

RL51 Relocating Linker tor 8051 family Microcontrollers 

S I'C Message Start Condition 

P I'C Message Stop Condition 

A I'C Message Acknowledge 

N I'C Message Negative Acknowledge 

SIvW I'C Message Slave Address + Write 

SIvR I'C Message Slave Address + Read 

Sub I'C Slave Subaddress 

NV-Memory I'C Controlled Non Volatile Memory (E'PROM) 
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1.4. References. 

[1] I'C Specification 

I'C-bus compatible ICs 

Philips Components Data Handbook IC12a 1989 

[2] PUM-51 User's Guide for DOS Systems 
Intel corporation 

[3) MSC-51 Macro Assembler User's Guide tor DOS Systems 
Intel Corporation 

[4] MSC-51 Utilities User's Guide for DOS Systems 
Intel Corporation 

[5] Single-chip 8-bit microcontrollers PC883C552/PCB80C552. PCB83C652/PCB80C652 etc. 
fC-bus compatible ICs . 
Philips Components Data Handbook IC12a 1989 

[6] Single-chip 8-bit microcontroller PCB80C51 

Integrated circuits Book IC14 13B/ 
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2. GENERAL DESCRIPTION. 



2.1. Perspective. 

IIC51 is designed for use in stand-alone microcontroller l*C systems. It is mainly written to provide 



2.2. Functions. 

I ICS! contains the following functions: 

- initialisation of the I'C interlace (software and hardware) 

- Transfer of I'C messages to and from an I'C slave device 

- Error detection 

- Automatic retrying it an error occurs during a transfer (up to 5 attempts) 

- Error recovery if the bus is held by a slave device that is out of bit-sync 

- Optional slave receiver / transmitter function (IIC51M only) 



IIC51 is designed to be a easy to use package. All needed code and data is defined in a single 
ob|ect module (IICS1M.OBJ or IIC51S.OBJ). The PLM5I user needs only to link this module to his 
own application object modules, using Intel's RL51. Procedures and data of concern to the user can 
be declared EXTERNAL by including the file IIC51.DCL 



2.4. General Constraints. 

IIC51 is coded lor and translated by the Intel MSC-51 Macro Assembler. It is tested together with 
Intel PLM51 modules. Intel utilities used tor testing: 

- MSC-51 Macro Assembler. ASM51.EXE, Version V2.3 

- PL/M-51 Compiler. PLMS1.EXE. Version V1.2 and V1.3 

- MSC-51 Relocator and Linker, RL51.EXE. Version V3.1 

Development is done on an IBM-PC/AT running DOS. 
IIC51S needs: 

- 350 Bytes CODE (approx.) 

- 6 Bytes DATA 

- 1 Byte Bit-Addressable DATA 

- 1 Bit 

IIC51M needs: 

- 400 Bytes CODE (approx.) 

- 6 Bytes DATA 

- 1 Byte Bit-Addressable DATA 

- 1 Bit 

- Exclusive use ot Register Bank 1 
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3. FUNCTIONAL DESCRIPTION. 



3.1. Master Mode Functions. 

This section describes the available (unctions in IIC51 on a procedure by procedure bases. 

Each procedure must be declared EXTERNAL by the PLM51 user. In this "JJJ ■* 
specrty the type returned by each procedure. All procedures (except J?^??n«Z 
a BYTE (depending on the chosen EXTERNAL declaration). The BIT or BYTE returned is if the 
I'C transmission was successful. If the user decides to declare a procedure untyped, the result of 
the previous I'C transmission can always be checked by examining the static BIT variable "C^nor 
Note that typed procedures must be called using an expression. If j» "J* J * "L2 Z^Zurl 
is to be ignored, a dummy assignment must be done for a typed procedure. An untyped P^ure 
can be called by the PLM51 CALL statement, without any additional overhead. The examples in the 
follow section assume the procedures to be declared untyped. 

Note that the least significant bit of all slaveaddresses passed to the I'C procedures must be 0. 



3.1.1. InltJ'C. 
Declaration: 

'"^PROCEDURE ( Own_Slave_Address ) EXTERNAL ; 

DECLARE ( Own_Slave_Address ) BYTE ; 
END ; 

Description: 

Init IIC must be called once after reset, before any other procedure is used. It initialises all 
I'Clntemal static data and hardware. The Own_Slave_Address is passed to Init IC for the 
optional stave function in a mutUmas.er I'C system (IIC51M). In a ""WW ft t}r.™ 
(IIC51S) the Own Slave Address is ignored. Note that InitJIC does not effect the global 
i intend enable flag (EA). IIC51M requires the user to enable interrupts afteiwards (see 
example). 

Example: 

CALL Inil IIC ( 54h ) ; 

ENABLE 7 r Enable Interrupts; EA » 1 / 
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3.1 2. IIC_T«tt_Devlce. 

Declaration: 



IIC_Test_Oevice: 

PROCEDURE ( Slave_Address ) [ BIT | BYTE ] EXTERNAL ; 



DECLARE ( Slave Address } 
END ; 

Description: 

IIC_Test_Devic8 just sends the slaveaddress on the r"C bus. It can be used to check the 
presence ot a device on the l*C bus. 

fC Protocol: 

( Device is Present, IIC_Error ■ ) 



s 


SlvW 


A 


P 


OR 


s 


SlvW 


N 


? 



DECLARE IIC_Error BIT EXTERNAL ; 



CALL IIC Test Device ( 8Ch ) ; 
IF ( IIC_Error ) THEN 

"Device is Not Present Handling' 
ELSE 

"Device is Present Handling" 



May 1989 



Philips Semiconductors Microcontroller Products 



Applicaiion Note 



PLM51 l 2 C software interface IIC51 (version 0.5) ETV/AN89004 



3.1 J. IIC_Wri*. 
Declaration: 
IIC Write: 

PROCEDURE ( Slave_Address, Count. Source_Ptr ) ( BIT | BYTE ] EXTERNAL ; 

DECLARE ( Slave_Address, Count. Source Ptr ) BYTE ; 
END ; 

Description: 

IIC_Write is the most basic procedure to write a message to a slave device. 

I'C Protocol: 

L • Count 

D1(0..L-1] BASED by Source_P1r 

















' // 
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Example: 

DECLARE Data_Butfer ( 4 ) BYTE ; 

CALL IIC_Write ( 0C2h. LENGTH ( Data_Butter ). Data_Burfer ) ; 
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3.1 A. IIC_Witt»_Sub. 

Declaration: 
IIC_Write_Sub: 

PROCEDURE ( Slave_ Address, Count, Source_Ptr, Sub_Address ) 

[ BIT | BYTE ] EXTERNAL ; 
DECLARE ( Slave_Address, Count, Source Ptr, Sub_Address ) BYTE ; 
END ; 

Descnplion: 

IIC_Write_Sub writes a message preceded by a subaddress to a slave device. 

fC Protocol: 

L - Count 

Sub - Sub Address 

D1[0..L-1] BASED by Source_Ptr 



s 


SlvW 




Sub 


A 


01 [0] 


A 


Dl[l] 


A 


11 


A 


D1[L-1] 


A 


P 


It 



Example: 

DECLARE Data_Butter ( 8 ) BYTE ; 



CALL IIC_Write_Sub ( 48h, LENGTH ( Data_Bufter ), .Data_Bufter, 2 ) ; 
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3.1 £. IIC_Wr1te_Sub_SWInc. 

Declaration: 

IIC Write Sub_SWInc: 

PROCEDURE ( Slave_Address, Count, Source.Ptr, Sub_Address ) 

[ BIT | BYTE ] EXTERNAL ; 
DECLARE ( Slave Address, Count. Source_Ptr, Sub_Address ) BYTE ; 
END ; 



Some l*C devices addressed with a subaddress do not automatically increment the subaddress 
alter reception ot each byte. IIC Write_Sub SWInc can be used tor such devices the same 
way HC_Write_Sub is used. IIC Write Sub SWInc splits up the message in smaller messages 
and increments the subaddress itself. 

I'C Protocol: 



L ■ Count 

Sub - Sub_Address 

D1[0..L-1] BASED by Source_Ptr 
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Example: 

DECLARE Data_Bu«er ( 6 ) BYTE ; 

CALL IIC_Wrtte_Sub_SWInc ( 80h, LENGTH ( Data_Butler ), .Data_Butter, ) ; 
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3.1.6. IIC_WrH»_M«mory. 

Declaration: 

IIC Wrl1e_Memory: 

PROCEDURE ( Slave_Address. Count. Source Ptr. Sub Address ) 

[ BIT | BYTE ] 

DECLARE ( Slave_Address, Count, Source_P1r, Sub_Address ) BYTE ; 
END ; 

Description: 

I'C Non-Volatile Memory devices ( such as PCF8582 ) need an additional delay : 
a byte to it IIC_Write_Memory can be used to write to such devices the 
HCWrite Sub is used. IIC Write Memory splits up the message in small 
increments the subaddress itself. After transmission of each small message a delay 
seconds is inserted. 

I*C Protocol: 

L « Count 

Sub - Sub Address 
D1[0..L-1] BASED by Source_Ptr 



EXTERNAL ; 
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a p < Delay 40 ms > 



DECLARE Data_Butter ( 10 ) BYTE ; 

CALL IIC_Memory ( OAOh. LENGTH ( Data_Buffer ), Data_Buffer. OFOh ) ; 
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3 1.7. IIC Write Sub Write. 

Declaration: 

K g£&^m~J**m. Coun.1. Source. S,b_Address. Coun*. » 
DECLARE ( Slave.Address, Countl . Source_Ptr1 , Sub.Address. CountZ. Source_Ptr2 ) 

END ; 
Description: 

„C_Wri«e_Sub Write writes 2 dam bloc* iprje. dec [by . isubaddre* ; ir ; °™ ™^ing 
slave device. This procedure can be used tor need an en 

method, without the need to put all data into one large butler. Such a oev.ee 
controlled teletext device; see example ). 

I'C Protocol: 



L - Countl 

M - Count2 

Sub - Sub_Address 
D1[0..L-1] BASED by Source_Ptr1 
D2[0..M- 11 BASED by Source_Ptr2 
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Example: 

PROCEDURE Write CCT_Memory ( Chapter. Row, Column Data But, Data.Coun. ) : 
DECLARE ( Chapter Row, Column. Data.Buf, Data.Count ) BYTE , 



will be stored relative to the extended address. 
CALL MC_Write_Sub_Write ( 22h, 3, Chapter, 8. Data.Bul, Data.Count ) ; 
END Wrtte_CCT_Memory ; 
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3.1.8. UCJtead. 

Declaration: 
IIC Read: 

PROCEDURE ( Slave_Address. Count, Dest_Ptr ) [ BIT | BYTE ] EXTERNAL ; 

DECLARE ( Slave_Address, Count. Dest_Ptr ) BYTE ; 
END ; 



IIC_Read is the most basic procedure to read a message from a slave device. 
I'C Protocol: 



M . Count 

D2(0..M-1] BASED by Dest_Ptr 
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DECLARE Data_Buffer ( 4 ) BYTE ; 

CALL IIC_Read ( 0B4h. LENGTH ( Data_Buffer ), .Data_Buffer ) ; 
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3.1.9. IIC_Read_Status. 

Declaration: 

' I SrOCEDUr| : ( Slave Address. Dest.Ptr ) [ BIT | BYTE ] EXTERNAL ; 
DECLARE ( Slave_Address. Dest.Ptr ) BYTE ; 
END ; 

Description: 

A lot of K devices nave only a one status byte that can be rea «h*lte ^^^^J 
be used tor this purpose. IIC_Read_Status works the same as IIC_Read but me user ooes *> 
have to pass a count parameter. 

I'C Protocol: 

M - Count 

Status BASED by Dest_Ptr 



s 


SlvR 


A 


Status 


N 


? 



Example: 

DECLARE Status_Byte BYTE ; 

CALL HC_Read_Status ( 84h. Status.Byte ) ; 
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3.1.10. IIC. 
Declaration 



IIC_Read_Sub: 

PROCEDURE ( Slave_Address. Count. Dest_Ptr, Sub_Address ) 

[ BIT I BYTE ] EXTERNAL 
DECLARE ( Slave_Address. Count, Dest_Ptr. Sub_Address ) BYTE ; 
END ; 



IIC Read_Sub reads a message from a slave device preceded by a write of the subaddress. 
Between writing the subaddress and reading the message an I'C restart condition is generated 
without surrendering the bus. This prevents other masters from accessing the slave device in 
between and overwriting the subaddress. 

£S Protocol: 

M « Count 

Sub - Sub_Address 

D2[0..M-1]BASED by Dest_Ptr 
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Example: 

DECLARE Data_Butfer ( 5 ) BYTE ; 

CALL IIC_Write_Sub ( 0A2h, LENGTH ( Data_Bufter ), ,Data_Buffer, 2 ) 
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3.1.11. IIC_Write_Sub_R»«d. 

Declaration: 

"p^WRfeTsiw.JWdnM. Countl. Source.Ptrl. Sub_Address f C^DgggJ^ 
DECLARE ( Slave_Address, Countl, Souro»_Ptr1, Sub_Address, CountZ. O^J^ . 
END ; 
Description: 

IIC Write Sub Read writes a data block preceded by a subaddress, generates an !'C restart 
conditionrand reads a data block. This procedure can be used for devices ; matt need ar, 
extended addressing method. Such a device is the ECCT (I'C controlled teletext device, see 
example ). 

I'C Protocol: 

L - Countl 

M - Count2 

Sub - Sub Address 
D1[0..L-1] BASED by Source_Ptr1 
D2(0..M-1]BASED by Dest_Ptr2 
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Example: 

PROCEDURE Read CCT Memory ( Chapter. Row, Column, Data.Buf, Data_Count ) ; 
DECLARE { ChapterT RoW: Column. Data.Bul. Data_Count ) BYTE ; 



The extended address (CCT-Cursor) is formed by Chapter. Row and Column. These 
three bytes are written after the subaddress (8). After that the actual data will be 
read relative to the extended address. 

CALL IIC_Write_Sub_Read ( 22h, 3, .Chapter, 8. Data.Buf, Data_Count ) ; 
END Read_CCT_Memory ; 
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3.2. Slav* Mod* Functions. 

tQ slave mode is provided by IIC51M only. All slave mode actions (except initialisation) take place 
in the S 101 interrupt procedure. Slave mode I'C protocol is very application dependent. It a specific 
slave mode is required, the user has to modify three procedures in IIC51M at source level. The 
following sections describe these procedures. The program examples of the procedures implement 
an I'C slave protocol to read and write the microcontroller's on chip RAM via I'C. This can be a 
uselul feature during program development and debugging. 



3.2.1. lnlt_Siav*. 

This procedure is called from MCJnit. In this procedure the user can initialise all static data 
concerning slave mode functions (If any). 

Example: 

Slave_Sub_Address : db 1 

Init_Slave: mov Slave_Sub_Address, #0 ; Initialise Sub Address 

ret 



3.2i. R*c*rv*_SI*ve. 

Receive_Slave is a procedure called from the SI01 interrupt procedure each time a byte is received 
from another I'C master. The procedure can make use of the bit •||CCntj1.BYTE1EXPECTED - . as 
defined in IIC51M. This bit is set to logic 1, every time the first data byte of an I'C message is 
about to be received. Receive_Slave can use this bit to detect the start of a new message. 

Normally all bytes received from the other master will be acknowledged (i.e. SI01 control bit Assert 
Acknowledge is set. AA . 1). It AA is cleared by Receive Slave subsequent bytes in the message 
will be ignored and a negative acknowledge will be transmitted alter reception of each byte. Note 
that the example does not make use ot this feature. 



Constraints: 

- Receive_Slave must read the S1DAT register. 

- Receive~Slave may dear the SI01 control bit AA, to stop acknowledging data. 

- ReceivelSlave may not effect any other SI01 hardware registers / bits. 

- Recetve_Slave is only allowed to use the accumulator and register RO in the current 
registerbank. 



Example: 

Receive_Slave : mov a, S1DAT 

mov rO, #Slave_Sub_Address 

jbc IlCCntrl . BYTE 1 EXPECTED , Save_Syte 

mov rO, Slave_Sub_Address 

inc Slave_Sub_Address 

Save_Byte: mov 8r0,a 

ret 



; Pick up data 

; Prepare for 1st byte 

; Jump if 1st byte 

; Else data byte 

; Postincrement Sub. 

; Save Data 

; Exit 



May 1989 



1-208 



Philips Semiconductors Microcontroller Products 



Application Note 



PLM51 l 2 C software interface IIC51 (version 0.5) 



ETV/AN89004 



3.2.3. S*nd_Slave. 

Send Slave is a procedure called 1^^^^^^^^^ 
transmitted to another I'C Send_Slave will be called 

Tg^— ^ « a^*" ' ^ "* 

reading I'C master. 

Constraints: 

- Send Slave must write to the SI DAT WaWtf. 



Example: 



Send Slave: 



mov rO, Slave Sub_Address 

mov SlDAT,8rO 

inc slave_Sub_Address 

ret 



pick up Sub Address 
Send Data 
Postincrement Sub. 
Exit 
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